home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / lan / merc130.zip / README.NDS < prev    next >
Text File  |  1996-05-30  |  33KB  |  657 lines
  1. Using Pegasus Mail and Mercury in NDS Mode under NetWare 4.1
  2. ------------------------------------------------------------------
  3.  
  4. Introduction
  5.  
  6. This document covers the operating theory of Pegasus Mail in the NetWare
  7. 4.1 environment using Novell's NDS user database structure. The target
  8. audience for this file is system administrators and those who are charged
  9. with maintaining the mail system. Because of the complexity of the
  10. NetWare 4.1 environment, we strongly recommend that you take some time to
  11. read this document thoroughly. We do, however, realise that many sites
  12. would prefer to get straight into things, so if you wish, you can bypass
  13. the theory and go straight to a step-by-step setup procedure by reading
  14. the file QSETUP.TXT supplied in this archive.
  15.  
  16.  
  17. Contents:
  18.  
  19.    1:   Summary
  20.    2:   Overview and operating requirements
  21.    3:   Contexts and operation
  22.    4:   Addresses
  23.    5:   Synonyms (alternative addressing formats)
  24.    6:   Installing Pegasus Mail for Windows in NDS Mode
  25.    7:   Installing Mercury in NDS Mode
  26.    7.1: Modifying MERCURY.INI for NDS use.
  27.    8:   Allowing Local User Lookup
  28.    9:   Extended Features
  29.    10:  Security Considerations
  30.    11:  POP3 server considerations
  31.    12:  Troubleshooting
  32.  
  33.  
  34. 1: Summary
  35.  
  36. This document provides information on running NDS-aware versions of
  37. Pegasus Mail for Windows and the Mercury MTS on NetWare 4.1 systems. 
  38. Because NetWare 4.1 does not have some of the features of NetWare 3.x 
  39. that made it possible to create a maintenance-free mail system, some
  40. extra work is required to set it up for optimum use, so you should
  41. take the time to familiarise yourself with this document thoroughly
  42. before attempting the installation.
  43.  
  44. In brief, installing Pegasus Mail for Windows entails following these 
  45. steps:
  46.  
  47.    * Install WPNNW4.DLL into the same directory as WINPMAIL.EXE
  48.    * Make sure current versions of the Novell API DLLs are installed
  49.      on your system
  50.    * Run the NDS-Aware version of PCONFIG to configure WinPMail for
  51.      each context on your server that needs its own configuration.
  52.    * Run the Pegasus Mail MAKEMBOX utility to create user mail
  53.      directories as required in each configured context.
  54.    * [Optional] Run the PMIGRATE utility to copy the mailbox contents
  55.      of any user who has previously run Pegasus Mail in Bindery Emulation
  56.      mode on your server to the new mailbox location.
  57.    * Install PMUSER.NLM, the mailbox maintenance utility, on your file
  58.      server.
  59.    * [Optional] Make a small change to NDS to allow local user lookup
  60.      (see section 7 in this file).
  61.  
  62. Installing the NDS-Aware version of Mercury on your file server is a 
  63. simpler process requiring these steps:
  64.  
  65.    * If you have never installed Mercury before, run SETUP.EXE
  66.      -- or --
  67.    * Install MERCNDS.NLM and MERCNDSS.NLM in SYS:SYSTEM
  68.    * Add a couple of new sections to your MERCURY.INI file
  69.    * [Optional] Install MERCNDSP.NLM in SYS:SYSTEM for POP3 support.
  70.  
  71. Installing Pegasus Mail and Mercury in NDS mode is slightly more complex
  72. than it is in Bindery Mode, but the ultimate aim is to produce a system
  73. with little or no ongoing maintenance or management requirement at the
  74. expense of a small amount of relatively simple extra initial setup and
  75. configuration.
  76.  
  77.  
  78. 2: Overview and operating requirements
  79.  
  80. In NDS mode, Pegasus Mail no longer uses the old NetWare 3.x SYS:MAIL
  81. directory structure to deliver and store mail: instead, it expects to
  82. deliver mail to a directory called PMAIL in each user's home directory on
  83. the file server. The MAKEMBOX utility creates the necessary directories
  84. for existing users, while the PMUSER NLM creates them automatically for
  85. each user that is created in future. The aim is to produce a system that
  86. is as nearly maintenance-free as possible, and to isolate Pegasus Mail
  87. from further disastrous changes in Novell system policy in future.
  88. Clearly, though, there are a couple of specific requirements that must
  89. be met in order to make this work:
  90.  
  91.    * All mail users must have a writable home directory in which they
  92.      have full rights.
  93.    * PMUSER.NLM must be run on every file server containing a partition
  94.      where Pegasus Mail users could be created.
  95.  
  96. PMUSER.NLM uses one service connection and about 10KB of server RAM in 
  97. normal use, and introduces almost no load on your server when it is idle. 
  98. PMUSER.NLM is not required if you use the NDS-Aware version of Mercury 
  99. to handle all of your mail delivery, since Mercury can duplicate the 
  100. functionality of PMUSER. Running PMUSER, however, allows Pegasus Mail's 
  101. local delivery agent to function normally, just as it always has under 
  102. NetWare 3.x and earlier.
  103.  
  104.  
  105. 3: Contexts and operation
  106.  
  107. NDS provides a tree structure which can contain many organizational
  108. units. Pegasus Mail's NDS-awareness supports the full idea of NDS,
  109. allowing different configurations for specific organizational units
  110. within your NDS tree. You can also create configurations that apply to a
  111. particular subtree of the NDS hierarchy, or even to the whole NDS tree by
  112. choosing where you place the configuration information.
  113.  
  114. To find its configuration information, Pegasus Mail starts in the user's 
  115. "Home context" - the organizational unit in the tree where the user was 
  116. created, and looks for a "Profile" object called "Pegasus Mail". If it 
  117. finds it, it parses the object's "Login script" attribute for its 
  118. configuration information. If it does not find the object, it changes up 
  119. one level in the NDS tree and repeats the search. The search continues 
  120. until either a configuration object is found, or else the root of the 
  121. tree is reached without finding a record. The NDS-aware version of 
  122. PCONFIG creates and maintains the "Pegasus Mail" profile object for you, 
  123. ensuring that all users have the rights necessary to be able to read its 
  124. login script. The Profile Object Pegasus Mail uses is, however, a 
  125. standard NDS data type, and can be easily manipulated using standard 
  126. Novell tools such as NWADMIN or NETADMIN, provided the user doing so has 
  127. sufficient rights.
  128.  
  129. Unlike running in NetWare 3.x mode, Pegasus Mail MUST find at least one 
  130. configuration record somewhere in the tree or it will refuse to run. The 
  131. context where Pegasus Mail finds its configuration record is known as the 
  132. "Configuration context" and is important for other reasons: Pegasus 
  133. Mail's control groups, such as GROUPMAIL, MAILUSERS and NOMAIL must all 
  134. be located in the configuration context in order to operate. Similarly, a 
  135. simple mail address, such as "Peter" is presumed to be relative to the 
  136. configuration context. This brings us to the next topic...
  137.  
  138.  
  139. 4: Addresses
  140.  
  141. Just as it does under NetWare 3.x, Pegasus Mail uses the native NetWare
  142. user naming structure when running in NDS mode. So, you can enter
  143. addresses like "Admin.pmail", or "CN=Admin.O=PMAIL" and Pegasus Mail will
  144. accept these as normal addresses, routing the mail as required. You can
  145. also use "relative addresses" - so if there is an organizational unit
  146. called "Dev" in the configuration context and it contains a user called
  147. "David", you can use "David.Dev" as an address as well.
  148.  
  149. Provided you install Pegasus Mail correctly in NDS mode, it can easily
  150. act as a low-maintenance enterprise-wide mail system providing mail
  151. services to all users throughout your NDS hierarchy.
  152.  
  153.  
  154. 5: Synonyms (alternative addressing formats)
  155.  
  156. Many sites have policies mandating that particular addressing formats
  157. should be used in their outgoing Internet mail - for example, a site may
  158. want its users' Internet addresses to consist of their initials and
  159. surname, like this: D.L.Harris@pmail.gen.nz. Basic address changes like
  160. this are beyond the scope of simple aliasing - they require the
  161. co-operation of both the mail program (Pegasus Mail) to ensure that the
  162. "from" field of the message is written properly in outgoing mail, and also
  163. of the Mail Transport System (Mercury) to ensure that incoming mail using
  164. the alternative address format is routed to the proper user. In the Pegasus
  165. Mail and Mercury systems, an address of this kind, which is